home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_usrdoc / SEEJPEG / README.{_1 < prev   
Text File  |  1999-09-17  |  10KB  |  247 lines
  1. seejpeg  v1.6.1        $Id: README,v 1.6 1996/11/01 19:15:36 evan Exp $
  2.  
  3. ------------------------------------------------------------------
  4. Copyright (C) 1993-1996 Evan Harris
  5.  
  6. Permission is granted to freely redistribute and modify this code,
  7. providing the author(s) get credit for having written it.
  8. ------------------------------------------------------------------
  9.  
  10. seejpeg is another JPEG viewer which utilizes svgalib and contains
  11. limited GIF, PPM, BMP and TARGA viewing support.
  12.  
  13. The most useful feature of seejpeg is that it automatically decides on
  14. the "best" video mode to use based on the image being displayed and
  15. the video card being used.  To aid it, various hints may be given as
  16. program options.  In the worst case, it may be overridden.
  17.  
  18. Video modes supported are limited to 1280x1024, 1024x768, 800x600,
  19. 640x480 and 320x200 in 256, 32K or 16M colours (assuming the video
  20. card, and svgalib, supports these modes).  Logical screen sizes are
  21. only limited by the size of video memory.
  22.  
  23. If the image is larger than the screen size the arrow keys may be used
  24. to scroll around that part of the image which could be loaded into
  25. video memory.  The Backspace key can be used to move to the previous
  26. image.  Pressing any other key moves to the next image, or exits the
  27. program.
  28.  
  29. ------------------------------------------------------------------
  30.  
  31. Program options
  32. ===============
  33.  
  34. -c    CENTRE IMAGE
  35.  
  36.     If the image is smaller than the video mode, the image is
  37.     centred on the screen.
  38.  
  39. -q    QUANTIZE PICTURE (256 colour mode)        (JPEG only)
  40.  
  41.     This option forces the image to be quantized into a colour map
  42.     with 256 entries, and subsequently seejpeg uses a 256 colour
  43.     mode.  If this option is not given seejpeg will not use a 256
  44.     colour mode unless the TESTMODE is not available (see below)
  45.     in which case it will implicitly set -q.  The default
  46.     quantization to use is two pass quantization - this is memory
  47.     intensive and may cause the machine to page if the image is
  48.     large or memory is small.  This should be the only occasion in
  49.     which seejpeg causes a machine to page.
  50.  
  51. -1    ONE PASS QUANTIZATION (-q implicit)        (JPEG only)
  52.  
  53.     As -q, except that it uses one pass quantization.  This does
  54.     not cause a machine to page, but the results are worse, unless
  55.     the image is greyscale.
  56.  
  57. -g    FORCE GREYSCALE MODE (-1 implicit)        (JPEG only)
  58.  
  59.     Display the image in greyscale.  This is not necessary for an
  60.     image compressed using the greyscale option on cjpeg as this
  61.     mode will be set automatically.  It can be used for images
  62.     compressed without the greyscale flag, or for displaying
  63.     colour images in greyscale.
  64.  
  65. -v    VERBOSE
  66.  
  67.     Display the video modes being used, the program version number
  68.     and lots of other stuff.  Without this option, seejpeg
  69.     operates silently.
  70.  
  71. -w    ONLY USE WIDTH TO DETERMINE VIDEO MODE
  72.  
  73.     By default, the video mode chosen is the smallest one possible
  74.     which is not smaller than the image.  This may not be
  75.     desirable for long, thin images.  It may be preferable to
  76.     choose the video mode based on the width only, rather than the
  77.     width and height, in which case this option should be used.
  78.  
  79. -f F    SET FUZZ FACTOR TO DETERMINE VIDEO MODE
  80.  
  81.     A video mode is selected if it is larger than the image.
  82.     Using this option allows a video mode to be selected if it is
  83.     larger than (or equal to) F * image_width and F *
  84.     image_height.  Currently, F must be in the range [0.5,1.0].
  85.     This option may be used in conjunction with -w to only use the
  86.     image width.
  87.  
  88. -F S    FORCE THE USE OF THE GIVEN VIDEO MODE
  89.  
  90.     To completely override the video mode selection routines a
  91.     video mode string (e.g. G640x480x32K) may be given instead.
  92.     If this is a 256 colour mode, quantization (-q) is
  93.     automatically selected.
  94.  
  95. -dx    DOUBLE THE SIZE OF THE IMAGE IN THE X DIRECTION
  96.  
  97. -s T    SHOW THE IMAGES IN A SLIDESHOW
  98.  
  99.     Each image is shown for T seconds.  The images can be scrolled
  100.     when being showed in a slideshow.  The slideshow cannot be
  101.     stopped or paused, except by the interrupt character
  102.     (e.g. ^C).
  103.  
  104. -C    CYCLE THROUGH ALL IMAGES
  105.  
  106.     The program does not exit after showing all the images,
  107.     instead it returns to the first image and shows them all
  108.     again.  Normally this can be stopped by pressing the Q key, at
  109.     which point it will continue to show all images in the cycle
  110.     and then stop.  When showing the images in a slideshow this
  111.     option will cause the slideshow to run forever (until
  112.     interrupted by, e.g., ^C).
  113.  
  114. -r    RANDOMISE THE ORDER OF THE IMAGES
  115.  
  116.     The images are shown in a random order.  If -C is specified, a
  117.     new random order is selected on each cycle.
  118.  
  119.  
  120. In addition to colour and greyscale JPEG formats, GIF, PPM, BMP and
  121. TARGA image formats are supported to a limited degree.  If the image
  122. is in GIF, PPM, BMP or TARGA format the -q, -1 and -g options are
  123. inoperative and, as a result, some video modes are not available for
  124. selection using -F.
  125.  
  126. Unfortunately, due to a limitation in libjpeg, the GIF support has to
  127. perform its own colour map construction so it can use 256 colour
  128. modes.  This may cause problems, although I haven't seen any yet.  GIF
  129. support currently only uses 256 colour modes, however changing this
  130. should be easy, if the demand is there for it.  GIF support has had
  131. limited testing.
  132.  
  133. PPM support is barely tested.  It uses 16M or 32K modes for colour
  134. images, and 256 modes for greyscale images.
  135.  
  136. BMP and TARGA support is completely untested.  The -targa option of
  137. cjpeg is not included in seejpeg, let me know if something like it is
  138. required.
  139.  
  140. ------------------------------------------------------------------
  141.  
  142. Compiling
  143. =========
  144.  
  145. NOTE: The file jpeglib/libjpeg.a was compiled on an a.out system, not
  146. an ELF system.  If you have an ELF system you should either get the
  147. JPEG v6 distribution and make libjpeg.a up yourself, or try to compile
  148. the shared library version (see below).
  149.  
  150. This program was tested using version 1.2.7 of svgalib.  It should
  151. also work with later versions.
  152.  
  153. The following symbols can be defined in the Makefile:
  154.  
  155. NO_32K_CASCADE    If the best mode is available in 16M and 32K modes and
  156.         the complete image doesn't fit in memory using the 16M
  157.         mode, the 16M mode is discarded and 32K mode used instead.
  158.         If you define this option this action does not happen.
  159.         The only time I can think of this option being useful is
  160.         if a video card supports 16M modes but not 32K modes.
  161.  
  162. TESTMODE    This video mode is tested for -
  163.         If the video card supports it, we assume that hicolor or
  164.         truecolor (32K or 16M) modes are available.
  165.         If the video card doesn't support it, we assume that only
  166.         256 colour modes are supported.
  167.         If this is not set in the Makefile, it is assumed to
  168.         be G640x480x32K.  If there is a video card which supports
  169.         hicolor or truecolor but not this mode, let me know of
  170.         a better default to test for and I'll change it in the
  171.         next release.
  172.  
  173. BUG_WORKAROUND  Some versions of svgalib with some video cards can
  174.         scramble the video mode when multiple files or
  175.         slideshows are shown.  This appears to be avoided
  176.         somewhat if the text video mode is set between each
  177.         picture.  This is what the workaround does.  This may
  178.         not be needed for some versions of svgalib or some
  179.         video cards.  It is for my CLGD5426 based card with
  180.         svgalib 1.06.  This option is defined by default in
  181.         the makefile.
  182.  
  183. Unless you change one of these options, or the default binary
  184. location, changing the Makefile should no longer be necessary.
  185.  
  186. PIX_ALIGN is no longer set in the Makefile.  If you wish to try
  187. different a value for it, see chiptype_init() in display.c.  If you
  188. lower PIX_ALIGN and it works, send me the changes.
  189.  
  190. You can build a version of seejpeg which uses the libjpeg-6 shared
  191. libraries (or even a version of libgr with the v6 JPEG libraries).
  192. This shared library is NOT included with seejpeg.  It is available on
  193. sunsite in /pub/Linux/libs, amongst others.  I have tested it, and it
  194. does work.  Note that you may need to adjust the GRHEADERS definition
  195. in the Makefile to find the JPEG header files.  The headers in jpeglib
  196. should not be used, in case they are different.
  197.  
  198. The current release has not been tested (by me) on an a.out system,
  199. although the library in jpeglib is an a.out one.
  200.  
  201. ------------------------------------------------------------------
  202.  
  203. Acknowledgements
  204. ================
  205.  
  206. The following people have contributed to the development of seejpeg.
  207. Thanks everyone.
  208.  
  209. Harm Hanemaayer <hhanemaa@cs.ruu.nl>
  210.     ongoing svgalib development, putting up with lots of silly
  211.     questions, providing lots of useful information, and a makefile
  212.     bug report
  213. <wolter@wppc9.oz.au>
  214. Jean-Francois Cordeau <cordeauj@jsp.umontreal.ca>
  215. Peter Mutsaers <muts@compi.hobby.nl>
  216. <ahughes@muddcs.cs.hmc.edu>
  217.     makefile bug report in 1.0
  218. Jeff Grills <jefftep@cs.utexas.edu>
  219.     colour lookup (256 colour mode) bug report in 1.2
  220. Michael Weller <eowmob@exp-math.uni-essen.de>
  221.     PIX_ALIGN patches against 1.1, prompting to add multiple
  222.     images and the slideshow
  223. Nils Rennebarth <nils@exp-math.uni-essen.de>
  224.     described how to compile with libgr-1.3 cleanly
  225. Lord Maximilien <lordmax@ix.netcom.com>
  226.     helped fixed Trident 800x600 problems, suggested the new options 
  227.     which were added in 1.6 
  228.  
  229. ------------------------------------------------------------------
  230.  
  231. Feedback
  232. ========
  233.  
  234. The current version was compiled and tested with svgalib version 1.2.7
  235. and a 1MB CLGD5426 based video card.  There are no known bugs with
  236. this configuration (in seejpeg, that is 8-).  If you find a bug with
  237. any configuration please report it, including all the information
  238. displayed using the "-v" option.
  239.  
  240. As of version 1.2, I have considered seejpeg "finished".  Future
  241. releases will primarily be bug and compatibility fixes, although new
  242. features may be added as well (as they were in 1.4, 1.5 and 1.6).
  243.  
  244. Please send any feedback, especially bug reports, to:
  245.  
  246. Evan Harris (evan@cs.mu.oz.au)
  247.